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Section 1 
Introduction 



1.1 GENERAL INFOIWATION 

Be sure to copy this master. For copy procedures, refer to 
Volume II, Production Operation of the DXIO Operating System 
Reference Manual , part number 946250-9702. 

All system command interpreter (SCI) commands in this document 
are given in abbreviated form and may be executed by entering the 
command exactly as is, or by using the interactive prompting from 
the SCI. For a discussion of the abbreviated command form, refer 
to Volume II, Production Operation, of the DXIO Operating System 
Reference Manual , part number 946250-9702. 



1.2 MEDIA DEFINITION 

Product shipments are made in three formats: 

* Pf^*^ - A DSIO, DS50, or DS200 disk pack or two dual- 
sided, double density diskettes that contain the object. 

* Magnetic Tape - An 800 bpi or 16 00 bpi magnetic tape 
that contains the object. 

* ^^-On - A disk pack that contains the source and one or 
more other products on the same disk pack. 

A disk map showing the contents of the media is included in the 
Product Documentation Package. 

The installation instructions in this document assume that the 
object files are on a disk named DD990 or a directory named 
.DD990. Section 2 describes how to convert the media to a disk 
named DD990 or a directory named .DD990. 



1.3 THE INSTALLATION PROCEDURE 

The object media contains the files and batch streams to perform 
the following: 

* Generate a data dictionary configuration 
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* Install the newly configured system on your DXIO system 

* Verify the installation 

1.4 SYSTEM REQUIREMENTS 

To successfully perform this installation procedure, you must 
have a functioning DXIO 3.X system. 
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Section 2 
Preparing for Installation 



2.1 INTRODUCTION 

Before executing the installation instructions, the object files 
must be prepared so that the batch stream can access them. The 
following paragraphs describe how to prepare each media. 



2.2 DISK FORMAT 

When the object is received on a disk or diskette, the following 
steps will prepare it for generation and installation. 

1. For disks: 

a. Put the installation disk in an available disk 
drive on a functioning DXIO 3.X system and load 
it. 

b. Install the disk using the following command: 

IV U=DSxx, V=DD990 

In this command, DSxx will be the disk drive on 
which DD990 has been loaded. 

c. Load the disk on which you want the object files 
installed. 

d. Install this disk using the following command: 

IV U=DSxx, V=< volume name> 

In this command, DSxx is the name of the disk 
drive in which you loaded the disk and <volume 
name> is the name of the disk on which you want 
the object files installed. 

e. To place the files in a directory, create a 
directory using the following coiranand: 

CPDIR P=<volume name>.DD990, M=100 
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In this command, <volume name> is the disk on 
which you want the object files installed. 

f . Copy the object files from the DD990 disk to the 
disk or directory using the following command: 

CD I=DD990, 0=<pathname> , L=. LISTING 

In this command, <pathname> is the pathname of 
the disk or directory on vrtiich you want the 
object files installed. 

2. For diskettes: 

a. Load the disk on which you want the object files 
installed. 

b. Install this disk using the following command: 

IV U=DSxx, V=<volume name> 

In this command, DSxx is the name of the disk 
drive in which you loaded the disk and <volurae 
name> is the name of the disk on which you want 
the object files installed. 

c. Load the diskette named DD990A in an available 
disk drive. 

d. Install the diskette using the following command: 

IV U=DSxx, V=DD990A 

In this command, DSxx is the name of the disk 
drive in which you loaded the diskette. 

e. To place the files in a directory, create a 
directory using the following command; 

CFDIR P=<volume narae>.DD990, M=100 

In this command, <volume name> is the disk on 
which you want the object files installed. 

f. Copy the contents of DD990A to the disk or 
directory using the following command: 

CD I=DD990A, 0=<pathname> , L=.LISTING1 

In this command, <pathname> is the pathname of 
the disk or directory on which you want the 
object files installed. 

g. When the copy is complete, unload the diskette 
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and load the diskette named DD990B. 

h. Install the diskette using the following conmiand: 

IV U=DSxx, V=DD990B 

In this command, DSxx is the disk drive in which 
the DD990B diskette was loaded. 

i. Copy the contents of this diskette to the disk or 
directory using the following command: 

CD I=DD990B, 0=<pathname> , L=.LISTING2 

In this command, <pathname> is the pathname of 
the disk or directory on which you want the 
object files installed. 

Now proceed to Section 3 for instructions for generating DD990. 

2.3 MAGNETIC TAPE FORMAT 

When the object is received on a magnetic tape, you must first 
move the files to a disk before beginning the installation 
process. To do this: 

1. Load the disk on v^ich you want the object files 
installed. 

2. Install this disk using the following command: 

IV U=DSxx, V=<volume name> 

In this command, DSxx is the name of the disk drive in 

which you loaded the disk and <volume name> is the name 

of the disk on which you want the object files 
installed. 

3. To place the files in a directory, create a directory 
using the following command: 

CFDIR P=<volume name>.DD990, M=100 

In this command, <volume name> is the disk on which you 
want the object files installed. 

4. Load the magnetic tape on an available tape drive. 

5. Move the contents of the magnetic tape to your disk or 
directory using the following command: 
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RD S=MTxx, D=<pathnaine> , L=. LISTING 

In this conrmand, <pathname> is the pathname of the disk 
or directory on which you want the object files 
installed. The file .LISTING now contains a listing of 
the directory restored from the magnetic tape. This 
file can be examined by executing a Show File (SF) or a 
Print File (PF) command. 

6. Unload the tape. 

Now proceed to Section 3 for instructions for generating DD990, 



2.4 ADD-ON FORMAT 

When you receive the object as an add-on package, use the 
following steps to prepare it for installation: 

1. Put the add-on disk in an available disk drive on a 
functioning DXIO 3.X system and load it. 

2. Install the disk using the following command: 

IV U=DSxx, V»< volume name> 

In this command, DSxx is the disk drive on which the 
volume was loaded and <volume name> is the volume name 
of the add-on disk. The volume name will be marked on 
the disk or you can execute a Show Volume Status (SVS) 
command to obtain the volume name. 

3. Load the disk on which you want the object files 
installed. 

4. Install this disk using the following command: 

IV U«DSxx, V=< volume name> 

In this command, DSxx is the name of the disk drive in 
which you loaded the disk and <volume name> is the name 
of the disk on which you want the object files 
installed. 

5. To place the files in a directory, create a directory 
using the following command: 

CFDIR P=<volume name>.DD990, M=100 

In this command, <volume name> is the disk on which you 
want the object files installed. 

6. Copy the DD990 directory from the add-on disk to the 
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disk or directory on which you want the object files 
installed using the following conimand: 

CD I=<volume narae>.DD990, 0=<pathname> , L=. LISTING 

In this command, <volume name> is the name of the add- 
on disk and <pathname> is the pathname of the disk or 
directory on which the object files will be installed. 

Now proceed to Section 3 for instructions for generating DD990, 
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Section 3 
Generating DD-990 



This section describes the procedure for generating a DD-990 
configuration. The most conmmon cause of errors in the 

generation process is lack of synonym space. Before beginning 
the generation process, execute the List Synonyms (LS) command. 
If the list of synonyms is more than 24 lines long, delete all 
your user synonyms before beginning the generation. 

1. Select the alternate procedure library using the 
following command: 

.USE DD990.S$CMDS,.S$PPOC 

2. Execute the generation procedure using the DDGEN 
command. This command is described in the Model 990 
Computer DD-990 User's Guide , part number 2276582-97017 

The DDGEN procedure executes in foreground for 
approximately two minutes and then returns to the SCI 
menu. If no errors are reported, a batch stream will 
have begun in background. This batch stream executes 
for approximately 20 minutes on a quiet system. Use 
the Wait (WAIT) command to wait for completion of the 
batch stream. 

When the batch stream completes, the following message 
will be displayed if any errors occurred: 

DDGEN complete with errors 

In_ this message, nn indicates the number of errors and 
<1 is ting file> indicates which file to check to 
determine the cause of the errors. 

The DD990 disk is now a master disk. This disk may be used for 
all installation procedures. The disk includes a file, 
DD990. CONFIG, that describes the generated configuration. You 
may look at this file using a Show Pile (SF) command or print it 
using a Print File (PP) command. 

When this process has completed successfully, exit from this mode 
using the following command: 
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.USE 

This returns the SCI menu and allows you to unload the DD990 
installation disk. 
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Section 4 
Installing DD-990 



This section describes the procedure to install DD-990 on your 
DXIO system. The procedure performs the following; 

* Deletes the existing DD-990 

* Installs the procedures and tasks required for DD-990 
The procedure steps are as follows: 

1. Select the alternate procedure library using the 
following command: 

.USE DD990.S$CMDS,.S$PROC 

2. Execute the installation procedure using the DDINS 
command. This command is described in the Model 990 
Computer DD-990 User^s Guide ,, part number 2276582-9701. 

This process executes in the foreground briefly and then 
continues in background for approximately 20 minutes on a quiet 
system. Enter the Wait (WAIT) command to wait for completion. 

When the execution has completed, if any errors have occurred, 
the following message is displayed: 

DDINS complete with errors 

In this message, nn indicates the number of errors and <listing 
file> indicates the file to check to determine the cause of the 
errors. 

When this process has completed successfully, exit from 
installation mode using the following command: 

• USE 

This returns the SCI menu and allows you to unload the DD990 
installation disk. 
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Section 5 
Verifying the Installation 



5.1 INTRODUCTION 

In order to test the installation of DD-990, perform the 
following steps: 

1. If DD-990 was installed on a site with DBMS-990, the 
data base must be running. If the data base is not 
running, enter the SDBMS command as follows: 

START DATA BASE MANAGER <L.V.E.> 

MAXIMUM DBMS USERS: 5 
MAXIMUM ASSIGNED PILES: 5 

MAXIMUM OPEN FILES: 5 
LOG FILE BLOCKING FACTOR: 1 

2. Execute the Assign Data Dictionary (ADD) command to 
assign the test dictionary as follows: 

ASSIGN DATA DICTIONARY <L.V.E. YYDD> 

DICTIONARY PATHNAME: .S$DD.TEST.DDF$ 

Respond with the test dictionary pathname 

.S$DD.TEST.DDF$. 

3. Execute the List Pile (LSTFIL) command as follows: 

LIST DDL FOR A FILE <L.V.E. YYDD> 

MASTER PASSWORD :<master password if DBMS security exist 
PILE NAME/ID :TEST-FILE 
LISTING ACCESS NAME:<output pathname> 
MODE (F,B) :P 

If the LSTFIL command completes successfully, the 
following output will be generated: 

FILE=TEST, TYPE=KIF 

NAME=DD-TEST-FI LE 

DESCRIPTION 

THIS LSTFIL OUTPUT INDICATES THAT DD-990 

HAS BEEN SUCCESSFULLY INSTALLED 
ENDD 
* 

ID=TSK Y=GROUP ,DUP=Y , MOD=N 
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NAME=TEST-FI LE-KEY 

FIELD=TSKl=CH/4 

NAME=TEST-FI LE-KEYl 

FIELD=TSK2=CH/4 

NAME=TEST-FILE-KEY2 

ENDK 

LINE=AO 
GROUP=TSKY 
NAME=TEST-FI LE-KEY 
FIELD=TSKl=CH/4 
NAME=TEST-PI LE-KEYl 
FIELD=TSK2=CH/4 
NAME'i^TEST-PI LE-KEY2 
ENDG 

FIELD=TSTF=CH/4 
NAME=TEST-FI LE-PI ELD 

ENDL 

* 

END. 



4. Execute the Release Data Dictionary (RDD) command to 
release the test dictionary file as follows: 

RELEASE DATA DICTIONARY <L.V.E. YYDD> 
ARE YOU SURE(Y/N)?: YES 

5. If the test dictionary file is not be used again, 
delete the directory .S$DD.TEST. 
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Section 6 
Removing DD-990 



If you no longer want DD990 on your system, the 
following procedure will remove the installed DD990. 
If DBMS is installed, DBMS must not be running. The 
dictionary must not be assigned when this procedure is 
executed. 

1. Assign the synonym $DSC to the disk on which you 
installed DD990 using the following command: 

AS S=$DSC, V=<volume name> 

In this command, < volume name> is the name of the disk 
on which DD990 is installed. 

2. Execute the erase batch stream using the following 
command : 

XB DD9 90. BATCH. DX. ERASE, L=. LISTING 

When the batch stream has completed, all DD990 procedures, tasks, 
and command procedures have been deleted from your system. 
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